CruiseControl.NET : File Labeller
This page last changed on Sep 01, 2008 by rosspatterson.
File Labeller
The File Labeller is used to generate labels based on the content of a disk file. The labeller is configured with the location of the file, and it reads the file content to generate the label for CCNet. The file is read just before the first pre-build task is executed.
The following configuration would prefix all labels with the string 'Foo-', so the if the file contains '213', the build would be labelled 'Foo-213'.
<project> <labeller type="fileLabeller"> <labelFilePath>xxx</labelFilePath> <prefix>Foo-</prefix> <allowDuplicateSubsequentLabels>true</allowDuplicateSubsequentLabels> </labeller> <!-- Other project configuration to go here --> </project>
Configuration Elements:
| Node | Description | Type | Required | Default |
|---|---|---|---|---|
| prefix | Any string to be put in front of all labels | string | false | empty string |
| labelFilePath | The pathname of the file to read. This can be the absolute path or one relative to the project's working directory. |
string | true | n/a |
| allowDuplicateSubsequentLabels | If true, , a label which matches the immediately previous label will be generated as is. Otherwise it will have a version number appended (e.g., prefixlabel-1, prefixlabel-2). | boolean | false | true |
 | The File Labeller was added in build 1.3.0.2870, and given the finishing touch in 1.3.0.2955. It is available in CCNet 1.3 and later. |
